4D Doc Center : CT Area to picture

4D Chart v13

CT Area to picture


CT Area to picture ( Bereich ; Geltungsbereich ) -> Funktionsergebnis

Parameter	Typ	Beschreibung
Bereich	Lange Ganzzahl	4D Chart Bereich
Geltungsbereich	Lange Ganzzahl	Geltungsbereich der Funktion: -2 = Dokument, -1 = Alle, 0 = Gewählte Objekte, >0 = Objekt-Kennummer
Funktionsergebnis	Bild	4D Bild der Objekte in Bereich

Beschreibung

Die Funktion CT Area to picture gibt ein 4D Bild der Objekte in Bereich zurück.

Die im Bild enthaltenen Objekte werden durch den Parameter Geltungsbereich gesteuert.

Bei Geltungsbereich gleich -2 wird das gesamte Dokument kopiert. Dazu gehören auch die Dokumenteinstellungen, z.B. die Anzeigeformate.
Bei Geltungsbereich gleich -1 werden alle Objekte in Bereich kopiert, jedoch ohne die Dokumenteinstellungen.
Bei Geltungsbereich gleich 0 werden nur die gewählten Objekte kopiert.
Bei Geltungsbereich größer als 0 muss er der Kennummer eines bestimmten Objekts entsprechen, es wird dann nur dieses Objekt kopiert.

Beispiel

Dieses Beispiel öffnet einen neuen Offscreen Bereich, erstellt ein Diagramm aus den vorhandenen Arrays, speichert das Diagramm in einer Bildvariablen und löscht dann den Offscreen Bereich wieder.

 Bereich:=CT New offscreen area

 vChart:=CT Chart arrays(Bereich;2;2;aCategory;aSeries;aValues)

 vPict:=CT Area to picture(Bereich;vChart)

 CT DELETE OFFSCREEN AREA(Bereich)